home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / graphic / chiaro10.zip / CHILS.DOC < prev    next >
Text File  |  1993-03-18  |  61KB  |  1,250 lines
  1. CHILS 1.1 DOCUMENTATION
  2. =======================
  3. James W. Birdsall
  4. 03/19/93
  5.  
  6.  
  7. 0. CONTENTS
  8. -----------
  9.    0.      CONTENTS
  10.    1.      INTRODUCTION
  11.     1.1     Quick Reference
  12.     1.2     Copyright, License, and Warranty Disclaimer
  13.   2.       USAGE
  14.    2.1      Targets
  15.     2.1.1    Wildcards
  16.    2.2      Options
  17.     2.2.1    -t Type
  18.     2.2.2    -s Complex Search
  19.     2.2.3    -v Verbose
  20.     2.2.4    -f Front End
  21.     2.2.5    -n No Truncate
  22.     2.2.6    -w Width
  23.     2.2.7    -# Version
  24.     2.2.8    -? Help
  25.   3.       CONFIGURATION FILE
  26.   4.       OUTPUT
  27.    4.1      GIF87a
  28.    4.2      GIF89a
  29.    4.3      IMG_1
  30.    4.4      JFIF1.01
  31.    4.5      SUNRAS
  32.    4.6      TARGA
  33.    4.7      PBM, PGM, PPM, PBM_RAW, PGM_RAW, PPM_RAW
  34.    4.8      XBM
  35.    4.9      WIN2BMP
  36.    4.10     OS2BMP11
  37.    4.11     WIN3BMP
  38.    4.12     OS2BMP20
  39.    4.13     PCX
  40.   5.       THE END
  41.  
  42.  
  43. 1. INTRODUCTION
  44. ---------------
  45.  
  46.    CHILS is a program of the Chiaro suite. It produces a quick listing
  47. of information about image files of many formats. Since it is not
  48. specific to any one format, it has been given the CHI- prefix instead of
  49. a particular format prefix. It automatically recognizes a variety of
  50. image formats. The information printed includes file name, file format,
  51. file size, and some details of image size, colors, etc., depending on
  52. what information the format contains and how accessible it is.
  53.  
  54.    The Chiaro suite is also available for UNIX systems.
  55.  
  56.  1.1 Quick Reference
  57.  -------------------
  58.  
  59.     This is a quick summary of the usage and options of CHILS. Invoking
  60. CHILS with the option "-?" will produce a similar summary. Complete
  61. explanations may be found in section 2.
  62.  
  63.    usage: chils [options] [target] [target target...]
  64.       target       filename, filename with wildcards, or path. Wildcards
  65.                    are *, ?, and ranges or groups specified in []. A
  66.                    range or group may be complemented with ^ or !.
  67.  
  68.      -tformat     TYPE: Only files of the specified format will be
  69.                    processed. Ignores the -v option. Multiple -t options
  70.                    may be specified. The identifiers recognized (case
  71.                    insensitive) are:
  72.  
  73.                         identifier      meaning
  74.                         -----------------------------
  75.                         GIF87a          GIF87a files
  76.                         GIF89a          GIF89a files
  77.                         GIF             Any GIF file, either GIF87a or GIF89a
  78.                         IMG_1           GEM IMG version 1 file
  79.                         IMG             Any GEM IMG file (only version 1
  80.                                          known to exist)
  81.                         JFIF101         JPEG File Interchage Format
  82.                                          version 1.00/1.01
  83.                         JFIF            Any JFIF file (only versions 1.00-1.01
  84.                                          known to exist)
  85.                         SUNRAS          Sun raster files
  86.                         TARGA           TARGA files
  87.                         PBM_NORM        Portable BitMap files, ASCII format
  88.                         PBM_RAW         Portable BitMap files, raw format
  89.                         PBM             Any Portable BitMap file
  90.                         PGM_NORM        Portable GrayMap files, ASCII format
  91.                         PGM_RAW         Portable GrayMap files, raw format
  92.                         PGM             Any Portable GrayMap file
  93.                         PPM_NORM        Portable PixMap files, ASCII format
  94.                         PPM_RAW         Portable PixMap files, raw format
  95.                         PPM             Any Portable PixMap file
  96.                         XBM             X11 BitMap files
  97.                         WIN2BMP         MS-Windows 2.x bitmap files
  98.                         OS2BMP11        OS/2 1.1-1.3 bitmap files
  99.                         WIN3BMP         MS-Windows 3.x bitmap files
  100.                         OS2BMP20        OS/2 2.0 bitmap files
  101.                         BMP             Any BMP file
  102.                         PCX_25          PCX version 2.5 files
  103.                         PCX_28          PCX version 2.8 files without palettes
  104.                         PCX_28P         PCX version 2.8 files with palettes
  105.                         PCX_30          PCX version 3.0 files
  106.                         PCX             Any PCX file
  107.  
  108.       -spattern    COMPLEX SEARCH: Allows complicated Boolean searches
  109.                     based on height, width, colors, and format. Format
  110.                     keywords are as for the -t option, above. Decimal
  111.                     numbers are allowed. Other operators are:
  112.  
  113.          ( )   parentheses          =     equal           H     height
  114.          }     greater than         {     less than       W     width
  115.          }=    greater or equal     {=    less or equal   C     colors
  116.          +     logical and          ,     logical or      F     file length
  117.  
  118.                     Example: -s(W}=640+H}=480),(GIF+C=256) searches for
  119.                     images at least 640 by 480, or any size GIF with 256
  120.                     colors.
  121.  
  122.      -v           VERBOSE: Prints a line for every file checked, whether
  123.                    the format was recognized or not.
  124.  
  125.      -f           FRONT END: For use as front end for GIFSTRIP or other
  126.                    Chiaro suite programs. Prints list of matching files
  127.                    on stdout. Ignores the -v option.
  128.  
  129.      -n           NO TRUNCATE: Do not remove path from filename in display.
  130.  
  131.      -w[n]        WIDTH: Override width of display.
  132.  
  133.      -#           VERSION: Prints version information on internal
  134.                    modules.
  135.  
  136.      -?           HELP: Prints a usage message.
  137.  
  138.    Options are case insensitive, and may not be combined.
  139.  
  140.  1.2 Copyright, License, and Warranty Disclaimer
  141.  -----------------------------------------------
  142.  
  143.    The Graphics Interchange Format(c) is the Copyright property of
  144. CompuServe Incorporated. GIF(sm) is a Service Mark property of
  145. CompuServe Incorporated.
  146.  
  147.   SunOS is a trademark of Sun Microsystems Inc.
  148.  
  149.   Targa and TrueVision are probably trademarks of AT&T.
  150.  
  151.   MS-Windows is probably a trademark of Microsoft.
  152.  
  153.   OS/2 is a registered trademark of IBM.
  154.  
  155.   Other terms in this document may be trademarks or service marks of or
  156. copyright by various corporations and organizations.
  157.  
  158.    CHILS is not in the public domain. All the files are copyright 1993
  159. by James W. Birdsall, all rights reserved.
  160.  
  161.    The following license applies to the entire Chiaro suite, which is
  162. made up of all the files listed in the file MANIFEST. Permission is
  163. granted to do the following:
  164.  
  165.         You may freely redistribute this archive, so long as it contains
  166.         all the files listed in the file MANIFEST, intact and
  167.         unmodified.
  168.  
  169.         You may use the programs contained in this archive for a period
  170.         of 30 days for evaluation purposes.
  171.  
  172.    Payment of the $10 shareware fee (which covers all the programs in
  173. the Chiaro suite) licenses you to use the Chiaro suite beyond the
  174. evaluation period. This license-to-use specifically includes use by
  175. bulletin board systems and other commercial or private information
  176. services.
  177.  
  178.    Registered users will also receive update notices and bug reports,
  179. and are entitled to use future versions without further payment.
  180.  
  181.    The contents of the distribution archive, and all other related
  182. files, information, and services are provided "as is" and without
  183. warranty. To the extent permitted by applicable law, the author
  184. disclaims all warranties, express or implied, including but not limited
  185. to, any implied warranty of merchantability or fitness for a particular
  186. purpose. While effort has been made to ensure that the files,
  187. information, and services are accurate and correct, the author shall not
  188. be liable for damages arising out of the use of or inability to use this
  189. product, including but not limited to, loss of profit, data, or use of
  190. this software, or special, incidental, or consequential dam